home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Various / S.N.A.G. Disk of the Month 90-07 (1990)(Southern Nevada Amiga Group)(PD).zip / S.N.A.G. Disk of the Month 90-07 (1990)(Southern Nevada Amiga Group)(PD).adf / Funstuff / IE! / ie.doc < prev    next >
Text File  |  1990-05-31  |  8KB  |  210 lines
  1.  
  2.          ***********************************************************
  3.          * IE - THE COMPLETE ICON EDITOR             (version 1.0) *
  4.          ***********************************************************
  5.  
  6.                          by Peter Kiem
  7.                             8 Southern Close,
  8.                         Chisholm A.C.T. 2905
  9.  
  10.  
  11.  
  12.   DISCLAIMER:
  13.  
  14.     mYou have the right to freely use, copy and distribute this program
  15.   as long as the following conditions are met:
  16.  
  17.     1.  The program and documentation are not modified in any way;
  18.     2.  The program is not used or included in any package for  profit
  19.       unless written consent from the author is obtained.
  20.  
  21.     NOTE: The author does not accept any responsibility for any damage
  22.     that might result from the use of this program.
  23.  
  24.     For a A$20 donation, the source code is available from the  author
  25.   at  the  listed address.  This source code is made available  for  other
  26.   programmers  as  a guide to Amiga programming and is not to be  used  to
  27.   distribute  modified  copies.  If you have  modifications  (improvements 
  28.   etc)  please  send  them to the  author.  These  modifications  will  be
  29.   included  in the  next  version  at  the  author's  discretion  with  an
  30.   appropriate recognition of the programmer in the program messages.
  31.  
  32.  
  33.  
  34.   FROM THE AUTHOR:
  35.  
  36.     Now we have dispensed with all the boring legal stuff, we can  now
  37.   get down to the interesting stuff:
  38.     I  am a CSO2 programmer with the Commonwealth  Public  Service.  I
  39.   own  an  Amiga 500 with 1 Meg memory, A590 Hard Drive  and  an  external 
  40.   floppy drive.  The compiler I own is Manx Aztec C version 3.6a.
  41.     I  wrote  IE  mainly as an exercise in learning Amiga  C,  but  it
  42.   started  out  with  a dissatisfaction with the  supplied  icon  programs
  43.   (ICONED and ICONMERGE).  I was disgusted with the fact that  dual-render
  44.   icons (icons that change picture when selected) could only be created by
  45.   using ICONED to make two icons and ICONMERGE to join the icons together.
  46.   ICONED also did not allow you to edit the dual-render icons so  created.
  47.   I  also have some large icons from off the public domain which were  too
  48.   large to be edited with ICONED.
  49.     I  then  resolved to create an icon editor with  all  conceiveable
  50.   icon functions with the capability of creating REALLY LARGE  dual-render
  51.   icons.
  52.     I  hope  that you find this program useful and you include  it  on
  53.   your system as a replacement to ICONED.
  54.  
  55.  
  56.  
  57.   FEATURES OF IE:
  58.  
  59.     IE has the following abilities:
  60.  
  61.     - Can create icons up to 640x200 pixels.
  62.     - Handles creation and editing of dual-rendered icons.
  63.     - Uses scroll bars for ease of moving around icon bitmap.
  64.     - Icon preview function allows you to see what your icon will look
  65.       like without leaving the program.  Any changes made to the  icon
  66.       bitmap can be seen immediately in the preview.
  67.         - Detaches from CLI for background running.
  68.     - Able  to  edit miscellaneous aspects of the icon  including  the
  69.       aspects edited by the WorkBench menu item "INFO"
  70.         - Icon Type (DISK/DRAWER/PROJECT/TOOL/GARBAGE)
  71.         - Icon Select Highlight (COMPLEMENT/BACKFILL/ALTERNATE PIC)
  72.         - Position of Icon (including FIND BEST POSITION)
  73.         - Stack Size (for project and tool icons)
  74.         - Default Tool (for disk and project icons)
  75.         - Definitions of up to 10 Tool Type strings
  76.         - Size  and  placement of opened window (for  disk,  drawer
  77.                   and garbage icons).
  78.     - Flood fill colouring.
  79.     - Iconify to shrink windows.
  80.     - Write Icon as C Code so your programs can write their own icons.
  81.       (Can also be used to generate C Code for 2 bitplane images so you
  82.        can use IE to create gadget images and save them as C Code for
  83.        inclusion in your programs).
  84.  
  85.  
  86.  
  87.   FEATURES YET TO BE IMPLEMENTED:
  88.  
  89.     Version 2.0 is in the pipeline for completion when I find the  time
  90.   to finish it.  The proposed features are as follows:
  91.  
  92.     - A better file requester.
  93.     - Read IFF picture as an icon bitmap.
  94.     - Write icon as IFF picture.  To allow the use of more sophisicated
  95.           packages' editing.
  96.         - Miscellaneous ideas too numerous to mention...
  97.  
  98.  
  99.  
  100.   CALLING IE:
  101.  
  102.     IE  can  be run from either the workbench or from the CLI.  To  run
  103.   IE from the CLI the following call is used:
  104.  
  105.     IE [filename]
  106.  
  107.   where filename is an optional parameter which is the icon to load.
  108.   NOTE:  IT  IS  NOT NECESSARY TO HAVE THE .INFO IN THE FILENAME.  THIS  IS
  109.   REMOVED BEFORE LOADING THE ICON AS THE SYSTEM ROUTINES DON'T LIKE IT.
  110.  
  111.  
  112.  
  113.   ICONIFY FUNCTION:
  114.  
  115.     By  selecting ICONIFY from the IE menus, all IE windows are  closed
  116.   and  a small window is opened.  This allows you to get IE totally out  of
  117.   the  way temporarily.  This small window can then be dragged to  anywhere
  118.   on  the screen.  To un-iconify IE simply activate the window by  clicking
  119.   the  left  mouse  button  in the window and then click  the  right  mouse
  120.   button.  All IE windows will the be opened in the same place and size  as
  121.   before.
  122.  
  123.  
  124.  
  125.   PREVIEW WINDOW:
  126.  
  127.     By selecting PREVIEW from the IE menus, a preview window is opened.
  128.   This window displays the icon as it will appear on the workbench  screen.
  129.   By clicking the left mouse button in this window, the icon render  images
  130.   change simulating the action of selecting the icon.
  131.  
  132.  
  133.  
  134.   INFO EDIT WINDOW:
  135.  
  136.     By selecting EDIT INFO from the IE menus, a info-editing window  is
  137.   opened.  This  window  allows you to change the icon type,  icon  render,
  138.   tool types, default tool and size of opened window amongst other things.
  139.  
  140.  
  141.  
  142.   CHANGING THE BITMAP:
  143.  
  144.     By clicking the left mouse button in the bitmap display on the left
  145.   side  of the main window, the selected pixel is changed to  the  selected
  146.   colour.  By  holding down the left mouse button and dragging the  pointer
  147.   you  can continuously draw in the bitmap.
  148.     When  the Flood Fill gadget is on, the action of clicking the  left
  149.   mouse  button  will  change  the area colour under  the  pointer  to  the
  150.   selected  colour.  It  probably is a good idea to save your  icon  BEFORE
  151.   doing a flood fill in case the area you selected wasn't properly  bounded
  152.   and  the  flood  fill  does more than  you  think.  Only  horizontal  and
  153.   vertical connections are checked for flood fill (diagonals are  ignored).
  154.     DON'T FORGET TO TURN OFF THE FLOOD FILL GADGET WHEN FINISHED!!!
  155.  
  156.  
  157.  
  158.   MOVING THE ICON BITMAP:
  159.  
  160.     By  selecting  the arrow gadgets, the icon  image  currently  being
  161.   displayed  is  moved 1 pixel within the bitmap editing display  to  allow
  162.   for expanding the size of the icon.
  163.  
  164.   
  165.  
  166.  
  167.   GENERATING C CODE:
  168.  
  169.     By  selecting  OUTPUT C CODE from the IE menus, the  icon  data  is
  170.   written to a file of your choice in the C language.
  171.     One use of this is for your programs to generate their own icons.
  172.  
  173.  
  174.   The following example shows how to write an icon to a file.  This assumes
  175.   you generated the C Code to a file called "c-code" and are generating the
  176.   icon "test.info":
  177.  
  178.     #include <exec/types.h>
  179.     #include <intuition/intuition.h>
  180.     #include <workbench/workbench.h>
  181.  
  182.     #include <functions.h>
  183.     #include "c-code";
  184.     extern struct IconBase *IconBase;
  185.  
  186.     void main()
  187.  
  188.     {
  189.       IconBase = (struct IconBase *)
  190.                      OpenLibrary("icon.library", LIBRARY_VERSION);
  191.       PutDiskObject("test", &Icon);
  192.       CloseLibrary(IconBase);
  193.       exit();
  194.     }
  195.  
  196.   You  can also use the generated C Code for any-size, 2  bit-plane  image.
  197.   For  example: you can draw the desired gadget pictures for  your  program
  198.   using  the  IE editor, generate the C Code to a file and  use  the  Image
  199.   definitions that were generated for use in your program.  
  200.  
  201.  
  202.  
  203.   FINAL NOTE:
  204.  
  205.     The  rest of the program I think is quite self explanatory  but  if
  206.   you require any help just contact me and I will help as much as I can.
  207.     I really hope that this program is of use to you and if you like it
  208.   give it to all of your friends.
  209.     Best wishes and happy Iconing...